Script Toolkit Documentation توثيق مجموعة الأوامر

Complete guide to all automation scripts — Mouse Mover, Work Manager & Xcode Active دليل شامل لجميع أوامر الأتمتة — محرك الماوس، مدير العمل و Xcode Active

🖱️ Mouse Mover Scripts أوامر تحريك الماوس

macOS Mouse Mover — Mac (.command) محرك الماوس — ماك (.command)

A Python-based script that moves your mouse cursor automatically at a customizable interval and distance. Keeps your screen active and prevents auto-lock/sleep.

سكريبت بايثون يحرك مؤشر الماوس تلقائياً بفترة زمنية ومسافة قابلة للتخصيص. يبقي شاشتك نشطة ويمنع القفل التلقائي والسكون.

📂 File

Mouse Mover_Mac.command

🚀 How to Use

1
Double-click the Mouse Mover_Mac.command file. Terminal will open.
2
Enter the timer interval in seconds (e.g., 5 = move every 5 seconds).
3
Enter the pixels per move (e.g., 50 = move up to 50px in each direction).
4
The mouse starts moving automatically. Press Ctrl+C to stop.

📂 الملف

Mouse Mover_Mac.command

🚀 طريقة الاستخدام

1
انقر مرتين على ملف Mouse Mover_Mac.command. سيفتح التيرمنال.
2
أدخل الفترة الزمنية بالثواني (مثال: 5 = تحريك كل 5 ثوانٍ).
3
أدخل عدد البكسلات لكل حركة (مثال: 50 = تحريك حتى 50 بكسل في كل اتجاه).
4
سيبدأ الماوس بالتحرك تلقائياً. اضغط Ctrl+C للإيقاف.

⏱️ Custom Timerمؤقت مخصص

Set any positive number as the interval (supports decimals like 0.5).

حدد أي رقم موجب كفترة زمنية (يدعم الكسور مثل 0.5).

📏 Pixel Distanceمسافة البكسلات

Control how far the mouse moves each time (e.g., 50px, 100px, 200px).

تحكم بمقدار حركة الماوس في كل مرة (مثال: 50 أو 100 أو 200 بكسل).

🎲 Random Directionاتجاه عشوائي

Mouse moves in a random direction each time for natural-looking motion.

الماوس يتحرك باتجاه عشوائي كل مرة لحركة تبدو طبيعية.

🖥️ Screen Boundary Safeحماية حدود الشاشة

Mouse stays within screen bounds (10px margin), never moves off-screen.

الماوس يبقى ضمن حدود الشاشة (هامش 10 بكسل)، لا يخرج أبداً خارج الشاشة.

📦 Auto-Install Dependenciesتثبيت تلقائي للمتطلبات

Automatically installs pyautogui if not found on your system.

يثبت مكتبة pyautogui تلقائياً إذا لم تكن موجودة على جهازك.

Input Validationالتحقق من المدخلات

Rejects invalid input (text, zero, negative numbers) with clear error messages.

يرفض المدخلات غير الصالحة (نص، صفر، أرقام سالبة) مع رسائل خطأ واضحة.

First run may take a moment to install pyautogui. After that it starts instantly.أول تشغيل قد يأخذ لحظة لتثبيت pyautogui. بعدها يبدأ فوراً.

Windows Mouse Mover — Windows (.bat + .ps1) محرك الماوس — ويندوز (.bat + .ps1)

A Windows batch + PowerShell combo that moves the mouse, blocks screen lock & sleep, presses an invisible F15 key to keep windows active, and optionally scrolls down/up. Runs hidden in the background.

مزيج من Batch و PowerShell يحرك الماوس، يمنع قفل الشاشة والسكون، يضغط مفتاح F15 غير مرئي لإبقاء النوافذ نشطة، ويمكنه اختيارياً التمرير لأسفل/لأعلى. يعمل مخفياً في الخلفية.

📂 Files (inside Mouse/ folder)

FilePurpose
StartMouseMove.batDouble-click to configure & start
MouseMover.ps1PowerShell engine (runs hidden)
StopMouseMove.batDouble-click to stop

🚀 How to Start

1
Double-click StartMouseMove.bat.
2
Enter pixel distance (default: 5px) — press Enter for default.
3
Enter interval in seconds (default: 5s) — press Enter for default.
4
Choose Enable scroll down/up? (Y/N, default: N) — adds page scrolling each cycle.
5
Script confirms settings and runs in the background. Close the window.

🛑 How to Stop

Double-click StopMouseMove.bat. It kills the process and restores normal sleep/lock behavior.

📂 الملفات (داخل مجلد Mouse/)

الملفالوظيفة
StartMouseMove.batانقر مرتين للإعداد والبدء
MouseMover.ps1محرك PowerShell (يعمل مخفياً)
StopMouseMove.batانقر مرتين للإيقاف

🚀 طريقة البدء

1
انقر مرتين على StartMouseMove.bat.
2
أدخل مسافة البكسلات (افتراضي: 5) — اضغط Enter للقيمة الافتراضية.
3
أدخل الفترة الزمنية بالثواني (افتراضي: 5) — اضغط Enter للقيمة الافتراضية.
4
اختر تفعيل التمرير لأسفل/لأعلى؟ (Y/N، افتراضي: N) — يضيف تمرير الصفحة كل دورة.
5
يعرض الإعدادات ويعمل في الخلفية. أغلق النافذة.

🛑 طريقة الإيقاف

انقر مرتين على StopMouseMove.bat. يوقف العملية ويعيد سلوك السكون/القفل الطبيعي.

🔒 Blocks Sleep & Lockيمنع السكون والقفل

Uses Windows API SetThreadExecutionState to prevent display off and system sleep.

يستخدم واجهة Windows API لمنع إيقاف الشاشة وسكون النظام.

👻 Hidden Backgroundيعمل مخفياً

PowerShell runs completely hidden — no visible window. Uses VBS launcher.

PowerShell يعمل مخفياً تماماً — لا نافذة ظاهرة. يستخدم مشغل VBS.

🔄 Zigzag Motionحركة متعرجة

Moves mouse forward then back (±pixels), returning close to original position.

يحرك الماوس للأمام ثم للخلف (±بكسل)، يعود قرب الموقع الأصلي.

🛡️ Duplicate Detectionكشف التكرار

Prevents running multiple instances. PID file tracks running process.

يمنع تشغيل أكثر من نسخة. ملف PID يتتبع العملية النشطة.

📜 Scroll Down/Upالتمرير لأسفل/لأعلى

Optional scroll toggle: scrolls the page down then back up each cycle using mouse_event API (360 units = 3 wheel clicks).

خيار التمرير: يمرر الصفحة لأسفل ثم يعيدها لأعلى كل دورة باستخدام واجهة mouse_event (360 وحدة = 3 نقرات عجلة).

⌨️ F15 Invisible Keyمفتاح F15 غير مرئي

Presses the invisible F15 key each cycle to keep the active window/session alive — no visible side effects.

يضغط مفتاح F15 غير المرئي كل دورة لإبقاء النافذة/الجلسة النشطة حية — بدون أي تأثيرات جانبية مرئية.

⚠️ StopMouseMove.bat restores normal sleep. Always stop before closing laptop!StopMouseMove.bat يعيد السكون الطبيعي. أوقفه دائماً قبل إغلاق اللابتوب!
💼 Work Manager Scripts أوامر إدارة العمل

macOS Start Work — Opens Everything بدء العمل — يفتح كل شيء

One-click script that launches all your work apps, opens browser tabs, starts HubStaff tracking, and runs your Xcode project — fully automated morning routine.

سكريبت بنقرة واحدة يفتح جميع تطبيقات العمل، يفتح تبويبات المتصفح، يبدأ تتبع HubStaff، ويشغل مشروع Xcode — روتين صباحي مؤتمت بالكامل.

📂 File

Mac Command/Start Work.command

🚀 How to Use

Just double-click the file. Everything happens automatically.

📋 What It Does (Step by Step)

StepActionDetails
1Opens AmphetaminePrevents Mac from sleeping
2Opens HubStaff & clicks StartAutomatically starts time tracking
3Opens Microsoft TeamsTeam communication
4Opens AntiGravityAI coding assistant
5Opens PostmanAPI testing tool
6Opens Chrome with 7 tabsGmail, App Store Connect, AI Studio, Cloud Billing, Claude AI, HubStaff Activity, Outlook
7Opens Xcode & runs projectOpens the most recent project and presses Cmd+R to build & run

📂 الملف

Mac Command/Start Work.command

🚀 طريقة الاستخدام

فقط انقر مرتين على الملف. كل شيء يحدث تلقائياً.

📋 ماذا يفعل (خطوة بخطوة)

الخطوةالإجراءالتفاصيل
1يفتح Amphetamineيمنع الماك من السكون
2يفتح HubStaff ويضغط بدءيبدأ تتبع الوقت تلقائياً
3يفتح Microsoft Teamsتواصل الفريق
4يفتح AntiGravityمساعد البرمجة بالذكاء الاصطناعي
5يفتح Postmanأداة اختبار API
6يفتح Chrome مع 7 تبويباتGmail, App Store Connect, AI Studio, Cloud Billing, Claude AI, HubStaff Activity, Outlook
7يفتح Xcode ويشغل المشروعيفتح آخر مشروع ويضغط Cmd+R للبناء والتشغيل
The terminal window auto-closes when done. Total startup takes ~45 seconds.نافذة التيرمنال تُغلق تلقائياً عند الانتهاء. إجمالي وقت البدء ~45 ثانية.

macOS Stop Work — Closes Everything & Logs Out إيقاف العمل — يغلق كل شيء ويسجل الخروج

One-click end-of-day script. Stops HubStaff tracking, quits all work apps, and logs you out of macOS.

سكريبت نهاية اليوم بنقرة واحدة. يوقف تتبع HubStaff، يغلق جميع تطبيقات العمل، ويسجل خروجك من macOS.

📂 File

Mac Command/Stop Work.command

📋 What It Does

StepAction
1Stops HubStaff time tracking (clicks Stop button)
2Quits: Chrome → Postman → Teams → AntiGravity → Xcode → HubStaff → Amphetamine
3Logs out of macOS (System Events log out)

📂 الملف

Mac Command/Stop Work.command

📋 ماذا يفعل

الخطوةالإجراء
1يوقف تتبع وقت HubStaff (يضغط زر الإيقاف)
2يغلق: Chrome ← Postman ← Teams ← AntiGravity ← Xcode ← HubStaff ← Amphetamine
3يسجل الخروج من macOS
⚠️ This will LOG YOU OUT of macOS! Save all unsaved work before running.هذا سيُسجل خروجك من macOS! احفظ كل أعمالك غير المحفوظة قبل التشغيل.
🔨 Xcode Active Simulator محاكي نشاط Xcode

macOS Xcode Active — Simulates Developer Activity Xcode Active — يحاكي نشاط المطور

An advanced script that simulates realistic human-like developer activity across Xcode, Simulator, Postman, and Chrome. Uses weighted random actions with natural delays.

سكريبت متقدم يحاكي نشاط مطور واقعي عبر Xcode و Simulator و Postman و Chrome. يستخدم إجراءات عشوائية موزونة مع تأخيرات طبيعية.

📂 Files

FilePurpose
Xcode Active.commandDouble-click to start simulation
Xcode Stop.commandDouble-click to stop simulation

📊 App Activity Distribution

AppWeightActions
Xcode (navigate)50%Next/prev tab, scroll up/down, navigate forward/back, jump to line, page scan
Simulator15%Scroll, tap, navigate back, browse items, press Home
Postman12%Switch tabs, scroll responses, browse sidebar collections
Chrome12%Switch tabs, scroll pages, refresh page
Xcode (Run)8%Build & Run (Cmd+R), check build status
Xcode (Stop)3%Stop app (Cmd+.)

🧠 Smart Features

📂 الملفات

الملفالوظيفة
Xcode Active.commandانقر مرتين لبدء المحاكاة
Xcode Stop.commandانقر مرتين لإيقاف المحاكاة

📊 توزيع النشاط بين التطبيقات

التطبيقالنسبةالإجراءات
Xcode (تصفح)50%التبويب التالي/السابق، التمرير لأعلى/لأسفل، التنقل للأمام/الخلف، القفز لسطر، مسح الصفحة
Simulator15%التمرير، النقر، الرجوع، تصفح العناصر، زر الرئيسية
Postman12%تبديل التبويبات، تمرير الردود، تصفح المجموعات الجانبية
Chrome12%تبديل التبويبات، تمرير الصفحات، تحديث الصفحة
Xcode (تشغيل)8%بناء وتشغيل (Cmd+R)، فحص حالة البناء
Xcode (إيقاف)3%إيقاف التطبيق (Cmd+.)

🧠 ميزات ذكية

🎯 Weighted Randomعشوائي موزون

50% time in Xcode (most realistic), balanced across other apps.

50% من الوقت في Xcode (الأكثر واقعية)، متوازن عبر التطبيقات الأخرى.

Human-Like Timingتوقيت يشبه البشر

Random 4-7 second delays between actions (not a fixed interval).

تأخيرات عشوائية 4-7 ثوانٍ بين الإجراءات (ليست فترة ثابتة).

🛡️ Single Instanceنسخة واحدة فقط

PID file prevents duplicate instances. Shows warning if already running.

ملف PID يمنع النسخ المكررة. يعرض تحذيراً إذا كان يعمل بالفعل.

🧹 Clean Shutdownإيقاف نظيف

Cleanup trap removes PID file on exit. Xcode Stop also cleans up stale PID.

فخ التنظيف يزيل ملف PID عند الخروج. Xcode Stop ينظف أيضاً PID القديم.

🚀 Smart Build Runsتشغيل بناء ذكي

Build & Run triggers only every ~10 cycles. Otherwise checks build status.

البناء والتشغيل يتم فقط كل ~10 دورات. وإلا يفحص حالة البناء فقط.

📱 Simulator Interactionتفاعل مع المحاكي

Taps, scrolls, navigates back, browses list items, and presses Home in iOS Simulator.

ينقر ويمرر ويرجع ويتصفح العناصر ويضغط زر الرئيسية في محاكي iOS.

Terminal auto-closes after starting. Runs silently until you use Xcode Stop.التيرمنال يُغلق تلقائياً بعد البدء. يعمل بصمت حتى تستخدم Xcode Stop.